home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Hyper / D / Dartmouth XCMD's Vol I.cpt / Dartmouth XCMD's Vol I / card_5128.txt < prev    next >
Text File  |  1990-12-13  |  3KB  |  55 lines
  1. -- card: 5128 from stack: in
  2. -- bmap block id: 0
  3. -- flags: 0000
  4. -- background id: 3241
  5. -- name: 
  6.  
  7.  
  8. -- part 1 (button)
  9. -- low flags: 00
  10. -- high flags: A003
  11. -- rect: left=79 top=300 right=322 bottom=179
  12. -- title width / last selected line: 0
  13. -- icon id / first selected line: 0 / 0
  14. -- text alignment: 1
  15. -- font id: 0
  16. -- text size: 12
  17. -- style flags: 0
  18. -- line height: 16
  19. -- part name: FieldToFile
  20. ----- HyperTalk script -----
  21. on mouseUp
  22.   FieldToFile "field 1"
  23.   put the result
  24. end mouseUp
  25.  
  26.  
  27.  
  28. -- part contents for background part 16
  29. ----- text -----
  30. FIELDTOFILE XCMD 1.2
  31. Kevin Calhoun
  32.  
  33. The FieldToFile XCMD allows you to save the contents of a HyperCard field in a text file.  You may designate the file to save to by passing its full pathname, or by choosing its folder and typing its name in a standard file dialog box.  FieldToFile does not append to existing files--it replaces them.  Therefore, if you supply the full pathname of the file, you should make sure you won't be replacing something vital.
  34.  
  35. If the standard file dialog is invoked, FieldToFile passes the short name of the field to SFPutFile as the original name of the file.
  36.  
  37. If an error occurs, FieldToFile returns an error message as the Result.  Word 1 of this message will be "Error."  If the file was written successfully, FieldToFile returns the full pathname of the file as the Result.
  38.  
  39. INVOKING FIELDTOFILE
  40. You may designate the field from which the text is to be copied in any way considered valid by HyperCard, by number, id, or name, with one exception:  you can't use the field's name if it is more than one word.  If you do use the field's name, don't put the field name in quotation marks.  Nested quotations confuse HyperCard.  (See the examples below.)
  41.  
  42. If you don't supply the pathname of the file to be written to, FileToField will invoke SFPutFile, and the user can specify the file's name and directory using the dialog box.  If the user pushes the cancel buton of the dialog box, FileToField returns "Cancel" as the Result.
  43.  
  44. If you want to be able to open your favorite word processor by double-clicking on the text file, you must supply the creator parameter.  For MacWrite, the creator is "MACA."  For Microsoft Word, the creator is "MSWD."
  45.  
  46. FieldToFile fieldDesignation,<full pathname of file>,<creator>
  47.  
  48. examples--
  49. FieldToFile "bkgnd field id 3"   --FieldToFile will invoke standard file
  50. FieldToFile "card field 5","TheFattaTheLand:Drop Folder:My Homework" 
  51. FieldToFile "field 1","MyHD:MyFile","MACA"
  52.  
  53. REVISION HISTORY
  54. 1.0 -- 3/7/88
  55. 1.2 --4/8/88 -- now saves to an AppleShare Drop Folder